『Design and Build Great Web Apis』
https://gyazo.com/facf23810118a3281453a21106780871
2020/10/27
Mike Amundsen 著
Pragmatic Bookshelf
https://pragprog.com/titles/maapis/design-and-build-great-web-apis/
/miyamonz-books/Design and Build Great Web APIsで見た
Getting Started
Getting Started with API First excerpt
Adopting the API-First Principle
Exploring APIs with curl
What’s Next?
Chapter Exercise
Understanding HTTP, REST, and APIs
Understanding Web API Protocols, Practices, and Styles
Managing Files with Git
What’s Next?
Chapter Exercise
The Design Phase
Modeling APIs
Understanding Norman’s Action Lifecycle
Modeling Our Onboarding API Lifecycle
Managing Your Project with npm
What’s Next?
Chapter Exercise
Designing APIs excerpt
The Power of Design
The API Design Method
Identifying Your API Descriptors
Creating Your Sequence Diagram
What’s Next?
Chapter Exercise
Describing APIs
Learning the Role of Description Formats
Describing Your API with ALPS
Updating Your API Project
What’s Next?
Chapter Exercise
The Build Phase
Sketching APIs excerpt
Learning from Frank Gehry’s Sketches
API Sketching Example
The Advantages of Sketching
Sketching APIs with Apiary Blueprint
API Sketching Tips and Tricks
What’s Next?
Chapter Exercise
Prototyping APIs
What Is an API Prototype?
API Prototyping with OpenAPI
Translating Your API Design into HTTP
Creating Your OpenAPI Document with SwaggerHub
Saving and Exporting Your API
Mocking Your API
Generating Your API Documentation
What’s Next?
Chapter Exercise
Building APIs
Defining the API Build Process
Relying on a Repeatable Process
Coding APIs with NodeJS and DARRT
Putting It All Together
What’s Next?
Chapter Exercise
The Release Phase
Testing APIs
The Goals of API Testing
Testing with SRTs
Using Postman for API Testing
Running Tests Locally with Newman
What’s Next?
Chapter Exercise
Securing APIs
Understanding Security Basics
Implementing API Security with Auth0
Supporting Machine-to-Machine Security
What’s Next
Chapter Exercise
Deploying APIs
The Basics of Deployment Pipelines
The Role of DevOps
Deploying with Heroku
What’s Next?
Chapter Exercise
Modifying APIs
Going Beyond Versioning
The Three Rules for Safely Modifying APIs
The Recommended Pattern for Testing for API Changes
The Process for Safely Deploying APIs
Shutting Down an Existing API
What’s Next?
Some Parting Thoughts
Getting Started
The Design Phase
The Build Phase
The Release Phase
What’s Next?
Appendixes
Installation Hints
curl
Git
GitHub and SSH
NodeJS and npm
Postman
Newman
Heroku Client
Installing the Local Utiltities
Exercise Solutions
Where’s the Code?
Solution for Chapter 1: Getting Started with API First
Solution for Chapter 2: Understanding HTTP, REST, and APIs
Solution for Chapter 3: Modeling APIs
Solution for Chapter 4: Designing APIs
Solution for Chapter 5: Describing APIs
Solution for Chapter 6: Sketching APIs
Solution for Chapter 7: Prototyping APIs
Solution for Chapter 8: Building APIs
Solution for Chapter 9: Testing APIs
Solution for Chapter 10: Securing APIs
Solution for Chapter 11: Deploying APIs
API Project Assets Checklist
Using the API Project Assets Checklist
Notes on the Assets Checklist
Your API Project Assets Checklist